home *** CD-ROM | disk | FTP | other *** search
/ Acorn User: China / Acorn User China CD-ROM (UK) (Disc B) / Acorn User China CD-ROM (UK) (Disc B).bin / ACORNUSERS / EMULATOR / FMSX / !Fmsx / !Help < prev    next >
Encoding:
Text File  |  1998-08-27  |  10.0 KB  |  251 lines
  1.  
  2.  
  3.                         ******* fMSX *******
  4.                  The Portable MSX/MSX2/MSX2+ Emulator
  5.                              version 1.5
  6.  
  7.                          by Marat Fayzullin
  8.                       
  9.                  Acorn Port by David McEwen 
  10.                  Port Version : 0.25 (27/8/98)
  11.                  
  12. New In This Version
  13. -------------------
  14.  
  15.  * Assembler plotter
  16.  * In built speed throttling on SA if Uperiod is 1
  17.  
  18.             
  19.                               
  20. Introduction
  21. ------------
  22.  
  23. This is a port of Marat's MSX emulator. This is an excellent emulator, it 
  24. basically provides a complete computer... This computer however has a great 
  25. selection of games... from Aleste to VKiller - a sort of Castlevania.
  26.  
  27. **Please ensure that your machine has at least 800k free**
  28.  
  29.  
  30. Use with pre RiscPC machines
  31. ----------------------------
  32.  
  33. The best way to get it running is to increase the Uperiod and decrease the
  34. Iperiod. This will unfortunately delay response, but will make it run faster.
  35. The screen mode is enforced at 320 by 256. The actual mode is determined by 
  36. colour depth so for 16 colours you will get Mode 9 and for 256 you will get
  37. Mode 13.
  38.  
  39.  
  40. What is MSX?
  41. ------------
  42.  
  43.   MSX is an old Z80-based family of home computers which appeared in 1982
  44. as an attempt to establish a single standard in home computing similar to
  45. VHS in video. They were popular in Asian (Korea, Japan) and South American
  46. (Brazil, Chile) countries as well as in Europe (Holland, France) and
  47. former Soviet Union, but they are virtually unknown in USA.  Although MSX
  48. standard quietly died to year 1988, the world got to see MSX2, MSX2+ and
  49. TurboR extensions of it. 
  50.   In spite of its sad history, MSX is a very nice computer, especially
  51. useful for educational purposes which is clearly indicated by example of
  52. the Soviet Union. Russian Ministry of Education bought hundreds of MSXes
  53. (and later MSX2s) grouped into "computerized classroom systems" of 10-16
  54. machines interconnected by a simple network. Entire generation of
  55. programmers has grown up using these computers. 
  56.   Hardware-wise, MSX represents a hybride of a Nintendo Entertainment
  57. System and a generic CP/M-80 machine. Its heart is Z80 CPU working at
  58. 3.58MHz in the base model (frequency was doubled in TurboR). The video
  59. subsystem is built around TI9918 or TI9928 VDP chip also used in Texas
  60. Instruments' TI-99/4 computers. In the later MSX models this chip was
  61. upgraded to V9938 (MSX2) and V9958 (MSX2+ and TurboR). The latest version
  62. is V9990. The audio system is handled by AY-3-8910 chip by General
  63. Electric, same as the one used in Sinclair ZXSpectrum128 audio. AY-3-8910
  64. provides 3 channels of synthetized sound, noise generation, and two
  65. general purpose parallel IO ports which are used for joysticks and some
  66. other things in the MSX design. Due to their hardware structure, MSX
  67. machines were perfectly suitable for games and there is a lot of good
  68. games either written or ported to them. You can find more information
  69. about MSX and remaining MSX fans at http://www.komkon.org/fms/MSX/
  70.  
  71.  
  72. How do I use it ?
  73. -----------------
  74.  
  75. There are various ways of using this machine, it depends on what you are 
  76. using :
  77.  
  78. Rom Images:<.rom files>
  79.     These should have dos extension stripped and be filetyped to MSXRom.
  80.     Then you can just double click on them.
  81.  
  82. Disks Images:<.dsk files> 
  83.     These should have dos extension stripped and be filetyped to MSXDsk.
  84.     Then you drag them to the Options window into either the drive A or
  85.     the drive B slot.
  86.     
  87. Tape Images:<.cas files>
  88.     These should have dos extension stripped and be filetyped to MSXTap.
  89.     Then you drag them to the Options window into the Tape slot.    
  90.      
  91. You can create or read Disk images using the programs wrdsk and rddsk respectively.
  92.  
  93. When using wrdsk please ensure that the files you are copy across have their DOS
  94. extensions as I haven't built in any conversion between filetypes and extensions.
  95. These are both very primitive programs that run in the command line. I have used
  96. the frontend module to create a crude front end for them. It would be
  97. preferable to have some sort of image file system, but I really don't have time
  98. to delve into that sort of thing! So if someone wants to write one I can provide
  99. them with the source to the reading and writing programs, which are direct ports
  100. of what is provided by Marat.
  101.     
  102. On the disks or tapes you may find files with extension .BIN,.OBJ or .GM
  103. These are o-called BLOADable binary files. They can be run from MSX 
  104. BASIC with 
  105.  
  106.                      BLOAD "filename",R
  107.  
  108. There may also be .COM files. These are MSX DOS command files.
  109. Boot MSX DOS and run them from there.
  110.  
  111. As standard the Acorn port comes with the following Roms:
  112. They are all stored in the !Fmsx.Roms directory. They don't need to be run
  113. separately. They are loaded automatically when found.
  114.  
  115. MSX         - Standard MSX BIOS and BASIC code
  116. MSX2         - MSX2 BIOS and BASIC code
  117. MSX2EXT         - MSX2 ExtROM containing system extensions
  118. MSX2P        - MSX2+ BIOS and BASIC code
  119. MSX2PEXT     - MSX2+ ExtROM containing system extensions
  120. DISK         - MSX DiskROM containing BDOS and DISK BASIC (optional)
  121. RS232        - RS232 BIOS and BASIC extensions (optional)
  122. FMPAC        - FM-PAC BIOS and BASIC extensions (optional)
  123. MSXDOS2      - MSXDOS2 system core (optional)
  124. CMOS         - Non-volatile memory used in MSX2 and MSX2+. This file gets 
  125.                rewritten on exit if non-volatile memory was changed.
  126.  
  127. This is an extra rom that can be found - just copy it into the Roms directory
  128. stripping the dos extension
  129. PAINTER      - Yamaha Painter, graphical editor found in Russian MSX
  130.                machines from Yamaha (optional)
  131.                
  132. The frontend allows you to alter various variables that will affect the
  133. speed of the game - the Uperiod and Iperiod values. Uperiod is the number of 
  134. interrupts per screen update and the Iperiod is the internal interrupt period. 
  135. In simple terms to speed up the emulator either increase Uperiod, decrease 
  136. Iperiod or both. To slow it down decrease Uperiod, increase Iperiod or both.
  137.  
  138. There are several resolution choices available. The first 4 are simple resolutions
  139. no scaling is implemented. The last 2 are full screen modes and these are exactly
  140. what they say. The slow version is slow because it plots 4 times the number of pixels.
  141. You can also select colour depth. The 16 colour version should be quicker in that
  142. the emulator is effectively writing less to screen... (however with a StrongARM I
  143. couldn't spot much difference in speed).
  144. The fast version is just y doubled. The MDF file included provides definitions for
  145. the modes on an AKF60 monitor. They are : 512 by 384 and 256 by 384 modes if you 
  146. wish to define your own.
  147.  
  148. Once the emulator is running the keys are mapped to their Acorn equivalents.
  149. So there is little or no difference to be spotted. There are a couple of keys 
  150. yet to be mapped, but they are of little importance. They will of course be 
  151. added in the next release.    
  152.               
  153. *FAQ*
  154. ----- 
  155.  
  156. Why are my Roms/Disk images not working ?
  157. -------------------
  158.  
  159. Try downloading them again. Try different machines, most games require an MSX 2
  160. Another thing to try is altering the MegaROM type... this is a matter of trial 
  161. and error.
  162.  
  163. If there is still no joy. Send the image to Marat and see if he can 
  164. find a reason.
  165.  
  166. Where's the sound ?
  167. -------------------
  168.  
  169. This is being worked on... as with the Coleco emulator I hope to get this
  170. working soon.
  171.  
  172. Do I need a special screen mode ?
  173. ---------------------------------
  174.  
  175. Nope the emulator runs happily in a 320 by 256 mode as the screen fits nicely. 
  176. The full screen modes require specially defined modes... a Mode Definition File 
  177. is included.
  178.  
  179. Will you get it to run in the desktop ?
  180. ---------------------------------------
  181.  
  182. This will be coming shortly, hopefully with sound!
  183.  
  184. fMSX version 2.0 is due out soon will you be porting this ?
  185. ------------------------------------------------------------
  186.  
  187. As soon as the source is available I shall get to work. It has some speed up 
  188. features in it that could help out in the quest for speed. It just depends on 
  189. Uni work what the timescale will be, but it shouldn't take long, the machine 
  190. is not very complex.
  191.  
  192. Will you be porting any other emulators ?
  193. -----------------------------------------
  194.  
  195. Yes! - although aren't 2(nearly 3) ports enough?
  196.  
  197. You probably already know about XNes...
  198. Look out for some interesting emulators then...
  199. Anyone out there heard of the Sega System 16 arcade setup?
  200.  
  201.  
  202. Copyright and Disclaimer
  203. ------------------------
  204.  
  205. This emulator is copyright Marat Fayzullin 1994-6, and the Acorn-specific
  206. components are copyright David McEwen 1998. You may not attempt to pass off
  207. any part of this work as your own, although you may distribute it freely as
  208. long as you supply the complete archive (that is, all the files supplied to
  209. you).
  210.  
  211. This software is supplied "as is". I make no claims about the reliability or
  212. suitability for any purpose of this emulator, and any use of it is undertaken
  213. at your own risk. No responsibility is taken for any failure of the software,
  214. or for any loss or damage caused directly or indirectly by the software.
  215.  
  216. Whilst I will endeavour to help you if you have problems with this emulator,
  217. no such support is guaranteed.
  218.  
  219. In the above "This emulator" refers to everything supplied within this
  220. archive, which is specifically the !Fmsx application and all the files
  221. contained within it, and also the documentation files (including the one you
  222. are reading now).
  223.  
  224.  
  225.  
  226. COMMENTS
  227. --------
  228.  
  229. Any comments about the emulator as such should go to Marat Fayzullin : 
  230. email : fms@komkon.org
  231. Website : http://www.komkon.org/fms
  232.  
  233. Any comments about the Acorn specific parts and please no inane emails giving 
  234. me ways of making money etc... just useful constructive stuff please
  235. email : dem95c@cs.nott.ac.uk
  236. Website : http://www.cs.nott.ac.uk/~dem95c
  237.  
  238.  
  239. Thanks
  240. -------
  241.  
  242. Thanks to Richard Hallas for creating some excellent icons for the emulator.
  243.  
  244. Thanks also to Gareth Moore for providing help on returning to the desktop
  245. screen mode (indeed I use his Redraw file!) and for putting info on his
  246. Acorn Gaming web site.
  247.  
  248. Thanks to David Sharp for putting information up on his excellent web site.
  249.  
  250. Thanks also to Acorn User for mentioning the emulator port in the April 1998
  251. issue.